home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / utils1 / js_pack2.arj / JS-PICK.TXT < prev    next >
Text File  |  1994-03-21  |  9KB  |  256 lines
  1. JS-PICK Utility Program Documentation
  2. (Ver 5.0)
  3.  
  4. Author: Johnathan Mark Smith
  5.  
  6.  
  7. THE OLD DISCLAIMER
  8.  
  9.   This software and manual are sold "as is" and without warranties
  10.   as to performance or merchant ability or any other warranties
  11.   whether expressed or implied. Because of the various hardware and
  12.   software environments into which this program may be put, no
  13.   warranty of fitness for a particular purpose is offered.
  14.  
  15.   The user must assume the entire risk of using and evaluating this
  16.   program. Any liability of  Johnathan Mark Smith Technology will be
  17.   limited exclusively to product replacement or refund of purchase
  18.   price. If you find these terms unacceptable, do not use this
  19.   product.
  20.  
  21. Introduction
  22.  
  23.         As time goes by, more and more Mainframe Systems are being down
  24. sized to run on PC's. One of the biggest setbacks is matching data
  25. from one file to the next file. The JS-PICK utility will simplify the
  26. task of checking to see if you have the same key on two files. JS-PICK
  27. must be provided with two files to match and a control file.
  28.  
  29.         JS-PICK can be used to:
  30.         1. Create a file with all the records on file one which have
  31.            a matching key on file two.
  32.         2. Create a file with all the records on file one which do not
  33.            have a matching key on file two.
  34.         3. Create a file selecting records from one file by using a key
  35.            file as file two.
  36.  
  37.         The best part is that JS-PICK can do all this without any of the
  38. files being sorted by the key used for matching. 
  39.  
  40.  
  41.     The JS-PICK program must be provided with control information
  42. to govern its execution. This information is read from a control file. 
  43. The control file is a standard PC text file that can be created with
  44. any ASCII text editor.
  45.  
  46. To run JS-PICK type at the prompt:    JS-PICK [options] <control file name>
  47.  
  48.  
  49.  
  50.                     THE CONTROL FILE:
  51.                     ----------------
  52.  
  53. The first line of the control file identifies the mode to run in.
  54.  
  55. The second line of the control file identifies the
  56. file(CALL THE MATCH ON FILE)  to match on,
  57. starting byte of the field to match on and the size of the field.
  58.  
  59. The third line of the control file identifies the file(CALL THE INPUT FILE)
  60. from which to pick off the matching and the non-matching records, and the
  61. starting byte of the key field.
  62.  
  63. The forth line of the control file identifies the file to put the
  64. matching records out to.
  65.  
  66. The fifth line of the control file identifies the file to put the
  67. non-matching records out to.
  68.  
  69. The following sample control file illustrates how control information 
  70. is provided to the JS-PICK program.
  71.  
  72.  
  73. Contents of a sample #1 of JS-PICK control file, JS-PICK1.CTL:
  74.  
  75.         BOTH
  76.         C:\DATA\KEYS.TXT,4,10
  77.         C:\DATA\INPUT.TXT,6
  78.         C:\DATA\MATCH.DAT
  79.         C:\DATA\NONMATCH.DAT
  80.  
  81. The word "BOTH" tells the program to create both output files.
  82.  
  83. Line #2 tells the program that the file(THE MATCH ON FILE) with the keys is
  84. "C:\DATA\KEY.TXT" and the key starts in byte 4 for the length of 10 bytes.
  85.  
  86. Line #3 tells the program that the input file name is
  87. "C:\DATA\INPUT.TXT" and the key starts in byte 6 of the input file.
  88.  
  89. line #4 tells the program to put the matching records in the file
  90. "C:\DATA\MATCH.DAT"
  91.  
  92. line #5 tells the program to put the non-matching records in the file
  93. "C:\DATA\NONMATCH.DAT"
  94.  
  95.  
  96. Contents of a sample #2 of JS-PICK control file, JS-PICK2.CTL:
  97.  
  98.         MATCH
  99.         C:\DATA\KEYS.TXT,4,10
  100.         C:\DATA\INPUT.TXT,6
  101.         C:\DATA\MATCH.DAT
  102.  
  103.  The word "MATCH" tells the program to create only a file with
  104. the matching records in it.
  105.  
  106. Line #2 tells the program that the file(THE MATCH ON FILE) with the keys is
  107. "C:\DATA\KEY.TXT" and the key starts in byte 4 for the length of 10 bytes.
  108.  
  109. Line #3 tells the program that the input file name is
  110. "C:\DATA\INPUT.TXT" and the key starts in byte 6 of the input file.
  111.  
  112. line #4 tells the program to put the matching records in the file
  113. "C:\DATA\MATCH.DAT"
  114.  
  115.  
  116. Contents of a sample #3 of JS-PICK control file, JS-PICK3.CTL:
  117.  
  118.         NOMATCH
  119.         C:\DATA\KEYS.TXT,4,10
  120.         C:\DATA\INPUT.TXT,6
  121.                 C:\DATA\NONMATCH.DAT
  122.  
  123. The word "NOMATCH" tells the program to create only a file with
  124. the non-matching records in it.
  125.  
  126. Line #2 tells the program that the file (THE MATCH ON FILE) with the keys is
  127. "C:\DATA\KEY.TXT" and the key starts in byte 4 for the length of 10 bytes.
  128.  
  129. Line #3 tells the program that the input file name is
  130. "C:\DATA\INPUT.TXT" and the key starts in byte 6 of the input file.
  131.  
  132. line #4 tells the program to put the non-matching records in the file
  133. "C:\DATA\NONMATCH.DAT"
  134.  
  135.  
  136. NOTE:
  137.       If line #1 is not one of the following (BOTH, MATCH, NOMATCH)
  138.       the program will default to BOTH. A match file and a nomatch file
  139.       must be supplied.
  140.  
  141.  
  142.  
  143.  
  144.                                OPTIONS:
  145.                                -------
  146.  
  147.         At the prompt when you type JS-PICK, there are two options
  148. available for the execution of that particular run.
  149.  
  150.         1) -iz     This option will tell the utility that the
  151.                    INPUT file is not CRLF and the record length
  152.                    is z long.
  153.  
  154.         2) -mz     This option will tell the utility that the
  155.                    MATCH ON file is not CRLF and the record length
  156.                    is z long.
  157.         
  158.         3) -s      This will surpress the graph that shows on
  159.                    the screen when JS-PICK is executed and the
  160.                    counters will only be displayed at program
  161.                    termination. The advantage of using this opiton
  162.                    is that the program will run MUCH, MUCH FASTER.
  163.                    (Try it!)
  164.  
  165.         4) -X      Turns off exiting on input data error
  166.  
  167.         5) -C      This option will turn off case sensitivity.
  168.                    JS-PICK will not care if the key is upper case,
  169.                    lower case, or a mix of both. For example:
  170.                    All these keys will match:   John
  171.                                                 JOHN
  172.                                                 john
  173.                                                 jOhN
  174.  
  175.  
  176.  
  177.         6) -t      To beep on exit.
  178. Registration
  179.  
  180.   I will keep improving the program if I know enough people are
  181.   finding it useful.
  182.  
  183.   My registration policy is very flexible. The nominal fee are listed
  184.   in the file REGISTER.TXT. If you don't feel you will get your money
  185.   worth of use out of JS-PICK, send whatever it is worth to you.
  186.   If you are impoverished and can't afford to pay anything,
  187.   enclose a stamped self-addressed envelope
  188.   and I will send you a registration.
  189.  
  190.   This is not freeware or public domain. Shareware is simply a means
  191.   of marketing commercial software. You are required to register if
  192.   you intend to use this program after a reasonable trial period.
  193.  
  194.   When registering, please tell me the version number you have 
  195.   and where you obtained your copy of JS-PICK.
  196.  
  197.   Foreign checks and credit cards OK. See REGISTER.TXT for details.
  198.  
  199.   JS-PICK should be registered for the maximum number of copies that
  200.   can be used simultaneously at your site. Site fees for commercial
  201.   users can be negotiated.
  202.  
  203.   If you register for the full fee, and enclose a Shipping and
  204.   Handling fee of $2 I will send you the latest versions of JS-PICK and
  205.   Some Free Demo's.  if you decide to use it after a trial period. 
  206.   I will also send other File related shareware programs.
  207.  
  208.  
  209. Registered version features
  210.  
  211. * FREE NEWSLETTERS
  212.  
  213. * CUSTOM DEFAULT SETTINGS
  214.  
  215. * DISCOUNTS ON SHAREWARE
  216.  
  217.  
  218. Program Abort
  219.  
  220.     Hitting Control-C (or Control-Break) will terminate the program
  221.     immediately. 
  222.  
  223.  
  224. Distribution
  225.  
  226.     Permission is hereby given to copy and distribute this program
  227.     as long as no more than $5 is charged. It must be made clear to
  228.     the buyer that this is only a handling charge and not a
  229.     registration fee. You must include all files in their original
  230.     unmodified form when distributing this program. .
  231.  
  232.     Permission to distribute may be revoked by the Johnathan Mark Smith 
  233.     at any time for any reason.
  234.  
  235.     YOU MUST NOT DISTRIBUTE ANY COPY WHICH HAS BEEN BRANDED WITH
  236.     A REGISTRATION CODE. 
  237.  
  238. All trademarks used in this document are the property of their
  239. owners.
  240.  
  241.                          -Johnathan Mark Smith-
  242.  
  243.  
  244. Questions or suggestions regarding JS-PICK should be directed to the
  245. author at the following address:
  246.  
  247.     Johnathan Mark Smith
  248.     2039 85 STREET
  249.     BROOKLYN, NY 11214
  250.  
  251.     Telephone: 718-373-3886
  252.  
  253.  
  254.  
  255.  
  256.